home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Communications / pop3d / README.INSTALL < prev    next >
Text File  |  1993-03-16  |  4KB  |  116 lines
  1. Installation Instructions for POP3 server (08-19-91)
  2. =========================================
  3.  
  4. General:
  5. The POP3 server is a TCP/IP server. It accepts one line commands,
  6. and responds with one or more ASCII text lines. For a complete
  7. description of the POP3 syntax, please refer to RFC 1225.
  8. The POP3 server is similar to the FTP and SMTP servers; it should
  9. be installed like ftpd and smtpd.
  10.  
  11. UNIX installation:
  12. -----------------
  13.  
  14. - copy and compile the   pop3d   program
  15. - copy the  pop3d  program to the   /etc   directory; it should
  16.   be owned by   root   and should have permissions   700
  17.   once installed, its directory listing should look something like this:
  18.  
  19.      -rwx------  1 root        30720 Aug 10  1990 /etc/pop3d
  20.  
  21.  
  22. - add an entry for   pop3d   in the file /etc/services
  23.   it should look like this:
  24.  
  25.      pop3        110/tcp        postoffice
  26.  
  27.  
  28. - add an entry for   pop3d   in the file /etc/inetd.conf
  29.   it should look like this:
  30.  
  31.      pop3    stream    tcp    nowait    root    /etc/pop3d    pop3d
  32.  
  33.  
  34. - restart the   inetd   program;  inetd  will connect incoming TCP/IP
  35.   traffic for the POP3 server to the   pop3d   program. Get the PID
  36.   number for   inetd   with the   ps   command; then restart  inetd:
  37.  
  38.      aggie: 9> ps -fax | grep inetd
  39.         92 ?  I     3:19 /etc/inetd
  40.      14470 p0 S     0:00 grep inetd
  41.      aggie: 10> kill -HUP 92
  42.      aggie: 11> 
  43.  
  44.  
  45. - pop3d  is now installed
  46.  
  47.  
  48.  
  49. Sun OS installation:
  50. -------------------
  51.  
  52. - copy and compile the   pop3d   program
  53.  
  54. - copy the  pop3d  program to the   /etc   directory (NOTE: network
  55.   files may be stored in a different directory on your system); it should
  56.   be owned by   root   and should have permissions   700
  57.   once installed, its directory listing should look something like this:
  58.  
  59.      -rwx------  1 root        49152 Feb  8  1990 /etc/in.pop3d
  60.  
  61. - if you use an /etc/services file,  add an entry for   pop3d   in the
  62.   file /etc/services it should look like this:
  63.  
  64.      pop3        110/tcp        postoffice
  65.  
  66. - add an entry for   pop3d   in the file /usr/etc/inetd.conf
  67.   it should look like this:
  68.  
  69.      pop3    stream    tcp    nowait    root    /etc/in.pop3d    in.pop3d
  70.  
  71.  
  72. - if you are running Yellow Pages, remake  yp
  73.  
  74. - restart the   inetd   program;  inetd  will connect incoming TCP/IP
  75.   traffic for the POP3 server to the   pop3d   program. Get the PID
  76.   number for   inetd   with the   ps   command; then restart  inetd:
  77.  
  78.      wilma% ps -ax | grep inetd
  79.        114 ?  IW    0:15 inetd
  80.       2082 p1 S     0:00 grep inetd
  81.      wilma% kill -HUP 114
  82.      wilma%
  83.  
  84.  
  85. - pop3d  is now installed
  86.  
  87.  
  88. Special note for various UNIX-like operating systems
  89. ====================================================
  90.  
  91. When you compile the server, you may get an error involving
  92. the    flock()    function or the    LOCK_EX and LOCK_UN
  93. constants. The purpose of these calls is to create an exclusive
  94. lock on the mailbox file. This prevents other processes from
  95. re-writing the mailbox while the POP server is also writing or
  96. reading from the mailbox.
  97.  
  98. In general, the flock() function may not be avialable on your system.
  99.  
  100. The 'brute force' way to get around this problem is to simply
  101. comment out the flock() calls. However, this will leave the mailbox
  102. file unprotected from other processes; if two processes write to the
  103. file at the same time, the results are undefined.
  104.  
  105. As an alternative, you should check the source code for other
  106. e-mail prcoesses on your system. Presumably, they will have some
  107. kind of file locking mechanism. Modify the POP3 server source
  108. code to use the same file locking mechanism.
  109.  
  110. -----------------------------------------------------------------------------
  111.  
  112. --  Katie Stevens
  113.     dkstevens@ucdavis.edu
  114.     Information Technology -- Campus Access Point
  115.     University of California, Davis
  116.